Close Menu

MTLLinkLabel

Introduction

Welcome to the documentation page for MTLLinkLabel — a customizable and easy-to-use replacement for UILabel, supporting clickable hyperlinks.

Installation

To install MTLLinkLabel using CocoaPods, add the following line to your Podfile:


pod 'MTLLinkLabel'

Usage

To use MTLLinkLabel in your application, follow these steps:

Step 1: Importing the Framework

In your view controller or class file where you intend to use MTLLinkLabel, import the framework:


import MTLLinkLabel

Step 2: Creating and Configuring MTLLinkLabel

Create an instance of MTLLinkLabel and set its properties as needed:


let linkLabel = MTLLinkLabel()
linkLabel.text = "Hello, visit our website"
linkLabel.linkColor = UIColor.blue
linkLabel.addLink("website", URL(string: "https://example.com")!)

Step 3: Handling Link Taps

To handle taps on the links inside MTLLinkLabel, you need to conform to the MTLLinkLabelDelegate protocol and implement the method linkLabel(_:didTapLink:):


class ViewController: UIViewController, MTLLinkLabelDelegate {
// ...

func linkLabel(_ label: MTLLinkLabel, didTapLink link: MTLLink) {
// Handle the link tap
}
}

Customization

MTLLinkLabel provides various customization options to enhance its appearance and behavior. Here are some of the properties you can modify:

  • textColor: Change the color of the label’s non-link text.
  • linkColor: Set the color of the links within the label.
  • underlineStyle: Customize the style of the underline for links.
  • font: Change the font of the label’s text.
  • numberOfLines: Control the number of lines for the label.

For more information about these and other available customization options, please refer to the MTLLinkLabel API documentation.

Advanced Usage

Besides handling link taps and customizing the appearance, MTLLinkLabel offers additional advanced features such as attributed text and link detection customization.

For a detailed guide on advanced usage scenarios and examples, please consult the MTLLinkLabel API documentation.

Troubleshooting

If you encounter any issues or have questions regarding MTLLinkLabel, please refer to the MTLLinkLabel GitHub repository for support or to report any problems.

Conclusion

Congratulations! You are now equipped with the knowledge to successfully implement and use MTLLinkLabel in your iOS application. Enjoy the convenience and functionality of clickable hyperlinks within your labels!