Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cretezy/flutter_linkify
Turns text URLs and emails into clickable inline links in text for Flutter
https://github.com/cretezy/flutter_linkify
dart flutter linkify
Last synced: about 3 hours ago
JSON representation
Turns text URLs and emails into clickable inline links in text for Flutter
- Host: GitHub
- URL: https://github.com/cretezy/flutter_linkify
- Owner: Cretezy
- License: mit
- Created: 2018-09-15T08:37:39.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-26T23:29:57.000Z (8 months ago)
- Last Synced: 2024-06-18T13:55:12.154Z (5 months ago)
- Topics: dart, flutter, linkify
- Language: C++
- Homepage: https://pub.dartlang.org/packages/flutter_linkify
- Size: 461 KB
- Stars: 261
- Watchers: 8
- Forks: 99
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# `flutter_linkify` [](https://pub.dartlang.org/packages/flutter_linkify)
Turns text URLs and emails into clickable inline links in text for Flutter.
Required Dart >=2.17 (has null-safety support).
[Pub](https://pub.dartlang.org/packages/flutter_linkify) - [API Docs](https://pub.dartlang.org/documentation/flutter_linkify/latest/) - [GitHub](https://github.com/Cretezy/flutter_linkify)
## Install
Install by adding this package to your `pubspec.yaml`:
```yaml
dependencies:
flutter_linkify: ^6.0.0
```
It is highly recommend that you also add a dependency on [`url_launcher`](https://pub.dartlang.org/packages/url_launcher) to open links in the browser/OS.
## Usage
Basic:
```dart
import 'package:flutter_linkify/flutter_linkify.dart';
Linkify(
onOpen: (link) => print("Clicked ${link.url}!"),
text: "Made by https://cretezy.com",
);
```
### Styling
Add a style to non-links (yellow) or links (red), and open in browser using [`url_launcher`](https://pub.dartlang.org/packages/url_launcher):
```dart
import 'package:flutter_linkify/flutter_linkify.dart';
import 'package:url_launcher/url_launcher.dart';
Linkify(
onOpen: (link) async {
if (!await launchUrl(Uri.parse(link.url))) {
throw Exception('Could not launch ${link.url}');
}
},
text: "Made by https://cretezy.com",
style: TextStyle(color: Colors.yellow),
linkStyle: TextStyle(color: Colors.red),
);
```
All `RichText` options are available for use.
### Linkify Options
By default, humanization (removal of `http://` or `https://` from the start of the URL) is enabled. You may disable it by passing `options`:
```dart
Linkify(
text: "Made by https://cretezy.com",
options: LinkifyOptions(humanize: false),
);
```
### Selectable Text
Use the `SelectableLinkify` widget to create selectable text. All `SelectableText` options are available for use.
```dart
SelectableLinkify(
text: "Made by https://cretezy.com\n\nMail: [email protected]",
);
```
### Advance
In the `onOpen` callback, a `LinkableElement` is passed in.
You can check if it is a `UrlElement` or `EmailElement` using `is` for custom handling.
You can enable parsing of only some link types using the `linkifiers` option. URL and email are enabled by default.
Full example can be found at [`example/lib/main.dart`](example/lib/main.dart).
