Add title prop (#97)

index.d.ts

@@ -31,4 +31,5 @@ export interface Props {
   symbol?: FaSymbol
   style?: CSSProperties
   tabIndex?: number;
+  title?: string;
 }

src/components/FontAwesomeIcon.js

@@ -50,7 +50,7 @@ function normalizeIconArgs(icon) {
 }
 
 export default function FontAwesomeIcon(props) {
-  const { icon: iconArgs, mask: maskArgs, symbol, className } = props
+  const { icon: iconArgs, mask: maskArgs, symbol, className, title } = props
 
   const iconLookup = normalizeIconArgs(iconArgs)
   const classes = objectWithKey('classes', [
@@ -69,7 +69,8 @@ export default function FontAwesomeIcon(props) {
     ...classes,
     ...transform,
     ...mask,
-    symbol
+    symbol,
+    title
   })
 
   if (!renderedIcon) {
@@ -142,6 +143,8 @@ FontAwesomeIcon.propTypes = {
 
   symbol: PropTypes.oneOfType([PropTypes.bool, PropTypes.string]),
 
+  title: PropTypes.string,
+
   transform: PropTypes.oneOfType([PropTypes.string, PropTypes.object])
 }
 
@@ -160,6 +163,7 @@ FontAwesomeIcon.defaultProps = {
   size: null,
   spin: false,
   symbol: false,
+  title: '',
   transform: null
 }
 

src/components/__tests__/FontAwesomeIcon.test.js

@@ -261,3 +261,16 @@ describe('symbol', () => {
     expect(spy.mock.calls[0][1].symbol).toBe('coffee-icon')
   })
 })
+
+describe('title', () => {
+  test('will not add a title element', () => {
+    const vm = mount({ icon: faCoffee })
+    expect(vm.children[0].type).not.toBe('title')
+  })
+
+  test('will add a title element', () => {
+    const vm = mount({ icon: faCoffee, title: 'Coffee' })
+    expect(vm.children[0].type).toBe('title')
+    expect(vm.children[0].children[0]).toBe('Coffee')
+  })
+})

src/converter.js

@@ -23,6 +23,9 @@ function styleToObject(style) {
 }
 
 function convert(createElement, element, extraProps = {}) {
+  if (typeof element === 'string') {
+    return element
+  }
   const children = (element.children || []).map(
     convert.bind(null, createElement)
   )