Como criar um link clicável em um NSAttributedString?

É trivial tornar os hiperlinks clicáveis ​​em um arquivo UITextView. Você acabou de definir a caixa de seleção "detectar links" na exibição no IB, e ele detecta os links HTTP e os transforma em hiperlinks.

No entanto, isso ainda significa que o que o usuário vê é o link "bruto". Arquivos RTF e HTML permitem que você configure uma sequência legível pelo usuário com um link "por trás" dela.

É fácil instalar o texto atribuído em uma exibição de texto (ou um UILabelou UITextField, nesse caso.) No entanto, quando esse texto atribuído inclui um link, ele não pode ser clicado.

Existe uma maneira de tornar o texto legível pelo usuário clicável em um UITextView, UILabelou UITextField?

A marcação é diferente no SO, mas aqui está a ideia geral. O que eu quero é um texto como este:

Essa transformação foi gerada com o Face Dancer , Clique para visualizar na loja de aplicativos.

A única coisa que posso obter é esta:

Essa transformação foi gerada com o Face Dancer. Clique em http://example.com/facedancer para visualizar na loja de aplicativos.

Use NSMutableAttributedString .

NSMutableAttributedString * str = [[NSMutableAttributedString alloc] initWithString:@"Google"];
[str addAttribute: NSLinkAttributeName value: @"http://www.google.com" range: NSMakeRange(0, str.length)];
yourTextView.attributedText = str;

Editar :

Não se trata diretamente da questão, mas apenas para esclarecer UITextFielde UILabelnão suporta a abertura de URLs. Se você deseja usar UILabelcom links, pode verificar TTTAttributedLabel .

Além disso, você deve definir dataDetectorTypeso valor do seu UITextViewpara UIDataDetectorTypeLinkou UIDataDetectorTypeAllpara abrir URLs quando clicado. Ou você pode usar o método delegado, conforme sugerido nos comentários.

Achei isso realmente útil, mas eu precisava fazer isso em alguns lugares, então envolvi minha abordagem em uma extensão simples para NSMutableAttributedString:

Swift 3

extension NSMutableAttributedString {

    public func setAsLink(textToFind:String, linkURL:String) -> Bool {

        let foundRange = self.mutableString.range(of: textToFind)
        if foundRange.location != NSNotFound {
            self.addAttribute(.link, value: linkURL, range: foundRange)
            return true
        }
        return false
    }
}

Swift 2

import Foundation

extension NSMutableAttributedString {

   public func setAsLink(textToFind:String, linkURL:String) -> Bool {

       let foundRange = self.mutableString.rangeOfString(textToFind)
       if foundRange.location != NSNotFound {
           self.addAttribute(NSLinkAttributeName, value: linkURL, range: foundRange)
           return true
       }
       return false
   }
}

Exemplo de uso:

let attributedString = NSMutableAttributedString(string:"I love stackoverflow!")
let linkWasSet = attributedString.setAsLink("stackoverflow", linkURL: "http://stackoverflow.com")

if linkWasSet {
    // adjust more attributedString properties
}

Objetivo-C

Acabei de atingir um requisito para fazer o mesmo em um projeto Objective-C puro, então aqui está a categoria Objective-C.

@interface NSMutableAttributedString (SetAsLinkSupport)

- (BOOL)setAsLink:(NSString*)textToFind linkURL:(NSString*)linkURL;

@end


@implementation NSMutableAttributedString (SetAsLinkSupport)

- (BOOL)setAsLink:(NSString*)textToFind linkURL:(NSString*)linkURL {

     NSRange foundRange = [self.mutableString rangeOfString:textToFind];
     if (foundRange.location != NSNotFound) {
         [self addAttribute:NSLinkAttributeName value:linkURL range:foundRange];
         return YES;
     }
     return NO;
}

@end

Exemplo de uso:

NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:"I love stackoverflow!"];

BOOL linkWasSet = [attributedString setAsLink:@"stackoverflow" linkURL:@"http://stackoverflow.com"];

if (linkWasSet) {
    // adjust more attributedString properties
}

Verifique se o atributo de comportamento do NSTextField está definido como selecionável.

Acabei de criar uma subclasse de UILabel para abordar especialmente esses casos de uso. Você pode adicionar vários links facilmente e definir diferentes manipuladores para eles. Ele também suporta o destaque do link pressionado quando você toca no touchdown para obter feedback. Consulte https://github.com/null09264/FRHyperLabel .

No seu caso, o código pode ser assim:

FRHyperLabel *label = [FRHyperLabel new];

NSString *string = @"This morph was generated with Face Dancer, Click to view in the app store.";
NSDictionary *attributes = @{NSFontAttributeName: [UIFont preferredFontForTextStyle:UIFontTextStyleHeadline]};

label.attributedText = [[NSAttributedString alloc]initWithString:string attributes:attributes];

[label setLinkForSubstring:@"Face Dancer" withLinkHandler:^(FRHyperLabel *label, NSString *substring){
    [[UIApplication sharedApplication] openURL:aURL];
}];

Captura de tela de amostra (o manipulador está configurado para exibir um alerta em vez de abrir um URL neste caso)

Pequena melhoria na solução da ujell: se você usa NSURL em vez de um NSString, pode usar qualquer URL (por exemplo, URLs personalizados)

NSURL *URL = [NSURL URLWithString: @"whatsapp://app"];
NSMutableAttributedString * str = [[NSMutableAttributedString alloc] initWithString:@"start Whatsapp"];
[str addAttribute: NSLinkAttributeName value:URL range: NSMakeRange(0, str.length)];
yourTextField.attributedText = str;

Diverta-se!

Swift 4:

var string = "Google"
var attributedString = NSMutableAttributedString(string: string, attributes:[NSAttributedStringKey.link: URL(string: "http://www.google.com")!])

yourTextView.attributedText = attributedString

Swift 3.1:

var string = "Google"
var attributedString = NSMutableAttributedString(string: string, attributes:[NSLinkAttributeName: URL(string: "http://www.google.com")!])

yourTextView.attributedText = attributedString

Eu também tinha um requisito semelhante, inicialmente usei o UILabel e depois percebi que o UITextView é melhor. Eu fiz o UITextView se comportar como o UILabel, desativando a interação e a rolagem, e criei um método de categoria para NSMutableAttributedStringdefinir o link para o texto, exatamente como o que Karl havia feito (+1 para isso).

-(void)setTextAsLink:(NSString*) textToFind withLinkURL:(NSString*) url
{
    NSRange range = [self.mutableString rangeOfString:textToFind options:NSCaseInsensitiveSearch];

    if (range.location != NSNotFound) {

        [self addAttribute:NSLinkAttributeName value:url range:range];
        [self addAttribute:NSForegroundColorAttributeName value:[UIColor URLColor] range:range];
    }
}

você pode usar o delegado abaixo para lidar com a ação

- (BOOL)textView:(UITextView *)textView shouldInteractWithURL:(NSURL *)url inRange:(NSRange)characterRange
{
    // do the task
    return YES;
}

Use o UITextView, que suporta links clicáveis. Crie uma sequência atribuída usando o seguinte código

NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:strSomeTextWithLinks];

Em seguida, defina o texto UITextView da seguinte maneira

NSDictionary *linkAttributes = @{NSForegroundColorAttributeName: [UIColor redColor],

                                 NSUnderlineColorAttributeName: [UIColor blueColor],

                                 NSUnderlineStyleAttributeName: @(NSUnderlinePatternSolid)};

customTextView.linkTextAttributes = linkAttributes; // customizes the appearance of links
textView.attributedText = attributedString;

Certifique-se de ativar o comportamento "Selecionável" do UITextView no XIB.

O cerne da minha pergunta era que eu queria criar links clicáveis ​​em exibições / campos / rótulos de texto sem precisar escrever um código personalizado para manipular o texto e adicionar os links. Eu queria que fosse orientado a dados.

Finalmente descobri como fazê-lo. A questão é que o IB não respeita os links incorporados.

Além disso, a versão iOS do NSAttributedStringnão permite inicializar uma sequência atribuída a partir de um arquivo RTF. A versão OS X do NSAttributedString faz ter um inicializador que leva um arquivo RTF como entrada.

NSAttributedString está em conformidade com o protocolo NSCoding, para que você possa convertê-lo para / de NSData

Criei uma ferramenta de linha de comando do OS X que usa um arquivo RTF como entrada e gera um arquivo com a extensão .data que contém o NSData do NSCoding. Em seguida, coloco o arquivo .data no meu projeto e adiciono algumas linhas de código que carregam o texto na exibição. O código fica assim (este projeto estava no Swift):

/*
If we can load a file called "Dates.data" from the bundle and convert it to an attributed string,
install it in the dates field. The contents contain clickable links with custom URLS to select
each date.
*/
if
  let datesPath = NSBundle.mainBundle().pathForResource("Dates", ofType: "data"),
  let datesString = NSKeyedUnarchiver.unarchiveObjectWithFile(datesPath) as? NSAttributedString
{
  datesField.attributedText = datesString
}

Para aplicativos que usam muito texto formatado, crio uma regra de construção que informa ao Xcode que todos os arquivos .rtf em uma determinada pasta são de origem e os arquivos de dados são a saída. Depois de fazer isso, basta adicionar arquivos .rtf ao diretório designado (ou editar arquivos existentes) e o processo de compilação descobre que eles são novos / atualizados, executa a ferramenta de linha de comando e copia os arquivos no pacote de aplicativos. Funciona lindamente.

Eu escrevi uma postagem no blog com links para um projeto de amostra (Swift) demonstrando a técnica. Você pode vê-lo aqui:

Criando URLs clicáveis ​​em um UITextField que é aberto no seu aplicativo

Exemplo Swift 3 para detectar ações em toques de texto atribuídos

https://stackoverflow.com/a/44226491/5516830

let termsAndConditionsURL = TERMS_CONDITIONS_URL;
let privacyURL            = PRIVACY_URL;

override func viewDidLoad() {
    super.viewDidLoad()

    self.txtView.delegate = self
    let str = "By continuing, you accept the Terms of use and Privacy policy"
    let attributedString = NSMutableAttributedString(string: str)
    var foundRange = attributedString.mutableString.range(of: "Terms of use") //mention the parts of the attributed text you want to tap and get an custom action
    attributedString.addAttribute(NSLinkAttributeName, value: termsAndConditionsURL, range: foundRange)
    foundRange = attributedString.mutableString.range(of: "Privacy policy")
    attributedString.addAttribute(NSLinkAttributeName, value: privacyURL, range: foundRange)
    txtView.attributedText = attributedString
}

func textView(_ textView: UITextView, shouldInteractWith URL: URL, in characterRange: NSRange) -> Bool {
    let storyboard = UIStoryboard(name: "Main", bundle: nil)
    let vc = storyboard.instantiateViewController(withIdentifier: "WebView") as! SKWebViewController

    if (URL.absoluteString == termsAndConditionsURL) {
        vc.strWebURL = TERMS_CONDITIONS_URL
        self.navigationController?.pushViewController(vc, animated: true)
    } else if (URL.absoluteString == privacyURL) {
        vc.strWebURL = PRIVACY_URL
        self.navigationController?.pushViewController(vc, animated: true)
    }
    return false
}

Da mesma forma, você pode adicionar qualquer ação que desejar com o shouldInteractWith URLmétodo UITextFieldDelegate.

Felicidades!!

A resposta rápida é usar UITextView em vez de UILabel. Você precisa ativar Selectablee desativar Editable.

Desative os indicadores de rolagem e salte.

Minha solução usando NSMutableAttributedStringfrom html stringNSHTMLTextDocumentType

NSString *s = @"<p><a href='https://itunes.apple.com/us/app/xxxx/xxxx?mt=8'>https://itunes.apple.com/us/app/xxxx/xxxx?mt=8</a></p>";

NSMutableAttributedString *text = [[NSMutableAttributedString alloc]
                                           initWithData: [s dataUsingEncoding:NSUnicodeStringEncoding]
                                           options: @{ NSDocumentTypeDocumentAttribute: NSHTMLTextDocumentType }
                                           documentAttributes: nil
                                           error: nil
                                           ];

cell.content.attributedText = text;

Eu escrevi um método, que adiciona um link (linkString) a uma string (fullString) com um determinado URL (urlString):

- (NSAttributedString *)linkedStringFromFullString:(NSString *)fullString withLinkString:(NSString *)linkString andUrlString:(NSString *)urlString
{
    NSRange range = [fullString rangeOfString:linkString options:NSLiteralSearch];
    NSMutableAttributedString *str = [[NSMutableAttributedString alloc] initWithString:fullString];

    NSMutableParagraphStyle *paragraphStyle = NSMutableParagraphStyle.new;
    paragraphStyle.alignment = NSTextAlignmentCenter;
    NSDictionary *attributes = @{NSForegroundColorAttributeName:RGB(0x999999),
                                 NSFontAttributeName:[UIFont fontWithName:@"HelveticaNeue-Light" size:10],
                                 NSParagraphStyleAttributeName:paragraphStyle};
    [str addAttributes:attributes range:NSMakeRange(0, [str length])];
    [str addAttribute: NSLinkAttributeName value:urlString range:range];

    return str;
}

Você deve chamar assim:

NSString *fullString = @"A man who bought the Google.com domain name for $12 and owned it for about a minute has been rewarded by Google for uncovering the flaw.";
NSString *linkString = @"Google.com";
NSString *urlString = @"http://www.google.com";

_youTextView.attributedText = [self linkedStringFromFullString:fullString withLinkString:linkString andUrlString:urlString];

Eu precisava continuar usando um UILabel puro, assim chamado pelo meu reconhecedor de toque (isso é baseado na resposta de malex aqui: Índice de caracteres no ponto de contato do UILabel )

UILabel* label = (UILabel*)gesture.view;
CGPoint tapLocation = [gesture locationInView:label];

// create attributed string with paragraph style from label

NSMutableAttributedString* attr = [label.attributedText mutableCopy];
NSMutableParagraphStyle* paragraphStyle = [NSMutableParagraphStyle new];
paragraphStyle.alignment = label.textAlignment;

[attr addAttribute:NSParagraphStyleAttributeName value:paragraphStyle range:NSMakeRange(0, label.attributedText.length)];

// init text storage

NSTextStorage *textStorage = [[NSTextStorage alloc] initWithAttributedString:attr];
NSLayoutManager *layoutManager = [[NSLayoutManager alloc] init];
[textStorage addLayoutManager:layoutManager];

// init text container

NSTextContainer *textContainer = [[NSTextContainer alloc] initWithSize:CGSizeMake(label.frame.size.width, label.frame.size.height+100) ];
textContainer.lineFragmentPadding  = 0;
textContainer.maximumNumberOfLines = label.numberOfLines;
textContainer.lineBreakMode        = label.lineBreakMode;

[layoutManager addTextContainer:textContainer];

// find tapped character

NSUInteger characterIndex = [layoutManager characterIndexForPoint:tapLocation
                                                  inTextContainer:textContainer
                         fractionOfDistanceBetweenInsertionPoints:NULL];

// process link at tapped character

[attr enumerateAttributesInRange:NSMakeRange(characterIndex, 1)
                                         options:0
                                      usingBlock:^(NSDictionary<NSString *,id> * _Nonnull attrs, NSRange range, BOOL * _Nonnull stop) {
                                          if (attrs[NSLinkAttributeName]) {
                                              NSString* urlString = attrs[NSLinkAttributeName];
                                              NSURL* url = [NSURL URLWithString:urlString];
                                              [[UIApplication sharedApplication] openURL:url];
                                          }
                                      }];

Atualizar:

Havia duas partes principais da minha pergunta:

1. Como criar um link em que o texto mostrado para o link clicável seja diferente do link real que é chamado:
2. Como configurar os links sem precisar usar código personalizado para definir os atributos no texto.

Acontece que o iOS 7 adicionou a capacidade de carregar o texto atribuído NSData.

Criei uma subclasse personalizada UITextViewque aproveita o @IBInspectableatributo e permite carregar o conteúdo de um arquivo RTF diretamente no IB. Você simplesmente digita o nome do arquivo no IB e a classe personalizada faz o resto.

Aqui estão os detalhes:

No iOS 7, NSAttributedStringganhou o métodoinitWithData:options:documentAttributes:error: . Esse método permite carregar um NSAttributedString a partir de um objeto NSData. Você pode primeiro carregar um arquivo RTF no NSData e depois usá-lo initWithData:options:documentAttributes:error:para carregá-lo na exibição de texto. (Observe que também há um método initWithFileURL:options:documentAttributes:error:que carrega uma sequência atribuída diretamente de um arquivo, mas esse método foi preterido no iOS 9. É mais seguro usar o método initWithData:options:documentAttributes:error:, que não foi preterido.

Eu queria um método que me permitisse instalar links clicáveis ​​nos meus modos de exibição de texto sem precisar criar nenhum código específico para os links que eu estava usando.

A solução que encontrei foi criar uma subclasse personalizada do UITextView que eu chamo RTF_UITextViewe fornecer uma@IBInspectable propriedade chamada RTF_Filename. A adição do @IBInspectableatributo a uma propriedade faz com que o Interface Builder exponha essa propriedade no "Attributes Inspector". Em seguida, você pode definir esse valor no IB sem código personalizado.

Também adicionei um @IBDesignableatributo à minha classe personalizada. o@IBDesignable atributo diz ao Xcode que ele deve instalar uma cópia em execução da sua classe de visualização customizada no construtor Interface, para que você possa vê-la na exibição gráfica da sua hierarquia de visualizações. () Infelizmente, para esta classe, a @IBDesignablepropriedade parece ser esquisita. Funcionou quando o adicionei pela primeira vez, mas excluí o conteúdo de texto sem formatação da minha exibição de texto e os links clicáveis ​​desapareceram e não consegui recuperá-los.)

O código para o meu RTF_UITextViewé muito simples. Além de adicionar o @IBDesignableatributo e uma RTF_Filenamepropriedade ao @IBInspectableatributo, adicionei um didSet()método à RTF_Filenamepropriedade O didSet()método é chamado sempre que o valor da RTF_Filenamepropriedade é alterado. O código para o didSet()método é bastante simples:

@IBDesignable
class RTF_UITextView: UITextView
{
  @IBInspectable
  var RTF_Filename: String?
    {
    didSet(newValue)
    {
      //If the RTF_Filename is nil or the empty string, don't do anything
      if ((RTF_Filename ?? "").isEmpty)
      {
        return
      }
      //Use optional binding to try to get an URL to the
      //specified filename in the app bundle. If that succeeds, try to load
      //NSData from the file.
      if let fileURL = NSBundle.mainBundle().URLForResource(RTF_Filename, withExtension: "rtf"),
        
        //If the fileURL loads, also try to load NSData from the URL.
        let theData = NSData(contentsOfURL: fileURL)
      {
        var aString:NSAttributedString
        do
        {
          //Try to load an NSAttributedString from the data
          try
            aString = NSAttributedString(data: theData,
              options: [:],
              documentAttributes:  nil
          )
          //If it succeeds, install the attributed string into the field.
          self.attributedText = aString;
        }
        catch
        {
          print("Nerp.");
        }
      }
      
    }
  }
}

Observe que, se a propriedade @IBDesignable não permitir a visualização confiável do texto com estilo no construtor de interface, será melhor configurar o código acima como uma extensão do UITextView em vez de uma subclasse personalizada. Dessa forma, você pode usá-lo em qualquer visualização de texto sem precisar alterar a visualização de texto para a classe personalizada.

Veja minha outra resposta se precisar oferecer suporte a versões do iOS anteriores ao iOS 7.

Você pode baixar um projeto de amostra que inclua essa nova classe no gitHub:

Projeto de demonstração DatesInSwift no Github

Basta encontrar uma solução sem código para o UITextView:

Ative a detecção-> opções de links, o URL e também o email serão detectados e clicáveis!

Versão rápida:

    // Attributed String for Label
    let plainText = "Apkia"
    let styledText = NSMutableAttributedString(string: plainText)
    // Set Attribuets for Color, HyperLink and Font Size
    let attributes = [NSFontAttributeName: UIFont.systemFontOfSize(14.0), NSLinkAttributeName:NSURL(string: "http://apkia.com/")!, NSForegroundColorAttributeName: UIColor.blueColor()]
    styledText.setAttributes(attributes, range: NSMakeRange(0, plainText.characters.count))
    registerLabel.attributedText = styledText

Use UITextView e defina dataDetectorTypes para Link.

como isso:

testTextView.editable = false 
testTextView.dataDetectorTypes = .link

Se você deseja detectar um link, número de telefone, endereço etc.

testTextView.dataDetectorTypes = .all

Uma rápida adição à descrição original de Duncan C sobre o comportamento de IB. Ele escreve: "É trivial tornar os hiperlinks clicáveis ​​em um UITextView. Você acabou de definir a caixa de seleção" detectar links "na exibição no IB, e ele detecta os links http e os transforma em hiperlinks".

Minha experiência (pelo menos no xcode 7) é que você também precisa desmarcar o comportamento "Editável" para que os URLs sejam detectados e clicáveis.

Caso você esteja tendo problemas com o que @Karl Nosworthy e @esilver haviam fornecido acima, atualizei a extensão NSMutableAttributedString para sua versão Swift 4.

extension NSMutableAttributedString {

public func setAsLink(textToFind:String, linkURL:String) -> Bool {

    let foundRange = self.mutableString.range(of: textToFind)
    if foundRange.location != NSNotFound {
         _ = NSMutableAttributedString(string: textToFind)
        // Set Attribuets for Color, HyperLink and Font Size
        let attributes = [NSFontAttributeName: UIFont.bodyFont(.regular, shouldResize: true), NSLinkAttributeName:NSURL(string: linkURL)!, NSForegroundColorAttributeName: UIColor.blue]

        self.setAttributes(attributes, range: foundRange)
        return true
    }
    return false
  }
}

A excelente biblioteca do @AliSoftware OHAttributedStringAdditions facilita a adição de links UILabelaqui é a documentação: https://github.com/AliSoftware/OHAttributedStringAdditions/wiki/link-in-UILabel

Se você deseja usar o NSLinkAttributeName em um UITextView, considere usar a biblioteca AttributedTextView. É uma subclasse UITextView que facilita muito o manuseio deles. Para mais informações, consulte: https://github.com/evermeer/AttributedTextView

Você pode fazer com que qualquer parte do texto interaja assim (onde textView1 é um UITextView IBoutlet):

textView1.attributer =
    "1. ".red
    .append("This is the first test. ").green
    .append("Click on ").black
    .append("evict.nl").makeInteract { _ in
        UIApplication.shared.open(URL(string: "http://evict.nl")!, options: [:], completionHandler: { completed in })
    }.underline
    .append(" for testing links. ").black
    .append("Next test").underline.makeInteract { _ in
        print("NEXT")
    }
    .all.font(UIFont(name: "SourceSansPro-Regular", size: 16))
    .setLinkColor(UIColor.purple) 

E para lidar com hashtags e menções, você pode usar código como este:

textView1.attributer = "@test: What #hashtags do we have in @evermeer #AtributedTextView library"
    .matchHashtags.underline
    .matchMentions
    .makeInteract { link in
        UIApplication.shared.open(URL(string: "https://twitter.com\(link.replacingOccurrences(of: "@", with: ""))")!, options: [:], completionHandler: { completed in })
    }

se você deseja substring ativo no seu UITextView, pode usar meu TextView estendido ... é curto e simples. Você pode editá-lo como quiser.

resultado:

código: https://github.com/marekmand/ActiveSubstringTextView

NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:strSomeTextWithLinks];

NSDictionary *linkAttributes = @{NSForegroundColorAttributeName: [UIColor redColor],   
                                 NSUnderlineColorAttributeName: [UIColor blueColor],
                                 NSUnderlineStyleAttributeName: @(NSUnderlinePatternSolid)};

customTextView.linkTextAttributes = linkAttributes; // customizes the appearance of links
textView.attributedText = attributedString;

PONTOS CHAVE:

• Certifique-se de ativar o comportamento "Selecionável" do UITextView no XIB.
• Certifique-se de desabilitar o comportamento "Editável" do UITextView no XIB.