Skip to content

Gridicons is a tiny framework which generates Gridicon images at any resolution.

License

Notifications You must be signed in to change notification settings

Automattic/Gridicons-iOS

Repository files navigation

Version License Platform

Gridicons iOS

Gridicons-iOS is a small framework which produces images of the Gridicons icon set.

The framework can be installed either via CocoaPods:

pod 'Gridicons', :podspec => 'https://raw.github.com/Automattic/Gridicons-iOS/develop/Gridicons.podspec'

or Carthage:

github 'Automattic/Gridicons-iOS'

Usage

First, import the framework:

import Gridicons

Getting a UIImage of a Gridicon is as simple as:

let icon = UIImage.gridicon(.pages)

With type inference, this can be shortened further:

icon = .gridicon(.pages)

You can optionally specify a size (default is 24 x 24):

let icon = UIImage.gridicon(.pages, size: CGSize(width: 100, height: 100))

The images that the framework produces use the AlwaysTemplate rendering mode, so you can tint them however you like.

Adding new icons

To add new icons as they're added to the Gridicons icon set, complete the following steps:

  • Add the icon from the pdf directory in the main Gridicons project to the Gridicons.xcassets catalog in this project
  • Rename the icon so it no longer has the gridicons- prefix
  • Select the icon in the asset catalog and change these settings:
    • Render As -> Template Image
    • Resizing -> Preserve Vector Data
    • Scales -> Single Scale
  • If you haven't already, run rake dependencies to install SwiftGen
  • Run rake gen to regenerate the GridiconsGenerated.swift file
  • Commit your changes and release a new pod version.

Updating existing icons

If you need to update a existing icon, update the PDF in the asset catalog with the new version and release a new pod version.

License

Gridicons-iOS is licensed under GNU General Public License v2 (or later).